package com.expert.miniapp.dao;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import java.util.List;

/**
 * 科技成果数据访问层接口
 * 提供科技成果相关的数据库操作方法
 */
@Mapper
public interface TechAchievementMapper {

    /**
     * 根据成果ID查询科技成果详情
     * @param achievementId 成果ID
     * @return 科技成果实体，如果不存在则返回null
     */
    TechAchievement findById(@Param("achievementId") String achievementId);

    /**
     * 根据技术分类查询科技成果列表
     * @param category 技术分类名称
     * @return 符合条件的科技成果列表
     */
    List<TechAchievement> findByCategory(@Param("category") String category);

    /**
     * 查询所有科技成果
     * @return 所有科技成果列表
     */
    List<TechAchievement> findAll();

    /**
     * 按权重排序查询科技成果列表（用于推荐）
     * @return 按权重随机排序的科技成果列表
     */
    List<TechAchievement> findByWeightOrder();

    /**
     * 模糊搜索科技成果
     * @param keyword 搜索关键词
     * @return 匹配关键词的科技成果列表
     */
    List<TechAchievement> searchByKeyword(@Param("keyword") String keyword);

    /**
     * 根据分类统计科技成果数量
     * @param category 分类名称（如："人工智能"）
     * @return 包含该分类的科技成果数量
     */
    Integer countByCategory(@Param("category") String category);
}